home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / bildschirmschoner / garshneblanker / gblankermod2 / gblankermod2.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  13KB  |  295 lines
  1. @database GBlankerMod2
  2. @master GBlankerMod2.guide
  3. @remark Hello world!
  4. @node "Main" "Garshneblanker modules collection vol.2"
  5.                     GarshneBlanker modules collection 
  6.             ---------------------------------
  7.                                  volume II
  8.                  ---------
  9.                          version 1.0 (Apr 04 1995)
  10.                   programs, sources and documentation are
  11.                       copyright 1995 Marzio De Biasi
  12.                             All Rights Reserved
  13. INDEX
  14. -----
  15.    [1] @{"GBlankerMod2.lha archive" link "P1" 0}
  16.    [2] @{"Installation" link "P2" 0}
  17.    [3] @{"NON-AGA machine owners" link "P3" 0}
  18.    [4] @{"Getting their best" link "P4" 0}
  19.    [5] @{"Bugs report and contributions" link "P5" 0}    <--<< please read this paragraph
  20.    [6] @{"About the author" link "P6" 0}
  21.    [7] @{"Acknowledgements" link "P7" 0}
  22.    [8] @{"Distribution" link "P8" 0}
  23.    [9] @{"Disclaimer" link "P9" 0}
  24.   [10] @{"advertising GBlankerMod1.lha ..." link "P10" 0}
  25. @endnode
  26. @node "P1" "Paragraph 1: GBlankerMod2.lha archive"
  27.   Foolish test:
  28.   -------------
  29.   Do you know what "screen blanker" mean?
  30.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  31.   +-> NO:  sorry, you lose!
  32.   +-> YES: Have you already downloaded M. D. Bayne's great Garshneblanker?
  33.        |  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34.        |
  35.        +------>    NO:    download it immediately!
  36.        |
  37.        +------>    YES:    Would you like to install two new blankers?
  38.          |    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  39.          +-------> NO:     drop this archive (SIGH!!)-;
  40.          +-------> YES: Have you already downloaded GBlankerMod1.lha?
  41.                 |   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42.                 |
  43.                 +----> YES: install these two new modules and
  44.                 |        enjoy them!
  45.                 |
  46.                 +----> NO:  go on reading, install these two
  47.                     new modules, and if you like'em try
  48.                     to download GBlankerMod1.lha, too.
  49.   In this archive you can find two NEW Garshneblanker modules:
  50.     1) MostlyDark blanker    : a TRUE blanker.
  51.     2) Waves blanker        : a blanker based on a wavy pattern.
  52.   They have been developed and tested using Garshneblanker version 38.8
  53.   ---------------------------------------------------------------------
  54.   (Release 36.6) and its source code distribution; if you have an older
  55.   ---------------------------------------------------------------------
  56.   version of Garshneblanker they will not work.
  57.   ---------------------------------------------
  58.   You can find their source codes in directories:
  59.     GSource/blankers/Waves/
  60.     GSource/blankers/MostlyDark/
  61.   but, in order to re-compile them, you'll need to get the original
  62.   Garshneblanker source distribution.
  63.   If you want to know more about them, you'll find some technical stuff in
  64.   files:
  65.     @{"Docs/Waves.doc" link "T1" 0}
  66.      @{"Docs/MostlyDark.doc" link "T2" 0}
  67. @endnode
  68. @node "P2" "Paragraph 2: Installation"
  69.   >>> If you have an Amiga equipped with 68020 or higher CPU: 
  70.       copy all files in directory GBlankerMod2/blankers020 to your
  71.       ------------------------------------------------------------
  72.       Garshneblanker blankers directory.
  73.       ---------------------------------- 
  74.       For example, if you've installed Garshneblanker and its modules in
  75.       SYS:WBStartup/, you can enter this from CLI:
  76.     CLI> copy GBlankerMod2/blankers020/#? SYS:WBStartup/blankers/
  77.   >>> If you have an Amiga equipped with 68000 CPU:
  78.       copy all files in directory GBlankerMod2/blankers to your
  79.       ---------------------------------------------------------
  80.       Garshneblanker blankers directory.
  81.       ---------------------------------- 
  82.       For example, if you've installed Garshneblanker and its modules in
  83.       SYS:WBStartup/, you can enter this from CLI:
  84.     CLI> copy GBlankerMod2/blankers/#? SYS:WBStartup/blankers/
  85. @endnode
  86. @node "P3" "Paragraph 3: NON-AGA machine owners"
  87.   If your Amiga ISN'T equipped with the AGA chipset, you must change
  88.   the blankers' default preferences, in order to make 'em work
  89.   properly.
  90.   If you're using a High-Res WB, the blankers will not work (or they will not
  91.   work properly), indeed they will try to open a 32 colors high-res screen.
  92.   In order to fix this problem, you must change the setting of both
  93.   blankers (entering their Prefs window): you can select LowRes Resolution
  94.   or reduce the number of colors they use (Depth).
  95.   NOTE:  after you've changed the prefs, don't forget to save'em
  96.      (simply click on Save button :-)
  97.   See also @{"Getting their best" link "P4" 0} paragraph.
  98. @endnode
  99. @node "P4" "Paragraph 4: Getting their best"
  100.   The blankers' default preferences are made for my
  101.   double-pal-high-res-no-flicker WB screen and they look good TO ME;
  102.   you can take'em as they are but I advise you to spent a few minutes
  103.           -----------------------------------------------------------
  104.   "playing" with their preferences until you find YOUR best configuration.
  105.   -----------------------------------------------------------------------
  106.   Here I suggest you some good settings:
  107.   Waves blanker
  108.   -------------
  109.         AGA machines            NON-AGA machines
  110.         ~~~~~~~~~~~~            ~~~~~~~~~~~~~~~~
  111.         SPOTS=3                SPOTS=3
  112.         WAVE LENGHT=50            WAVE_LENGHT=50
  113.         SIZE=4                SIZE=2
  114.         DELAY=15            DELAY=15
  115.         COLORS=32            COLORS=32
  116.         RES.=HIRES NOFLICK        RES=LOWRES
  117.         NOTE: the default settings
  118.         SPOTS=5                SPOTS=5
  119.         WAVE LENGHT=10            WAVE_LENGHT=10
  120.         SIZE=4                SIZE=2
  121.         DELAY=10            DELAY=15
  122.         COLORS=64            COLORS=32
  123.         RES.=HIRES NOFLICK        RES=LOWRES
  124.         NOTE: a very complex wave pettern
  125.         SPOTS=3                SPOTS=3
  126.         WAVE LENGHT=100            WAVE_LENGHT=100
  127.         SIZE=1                SIZE=1
  128.         DELAY=5                DELAY=10
  129.         COLORS=256            COLORS=32
  130.         RES.=LORES             RES=LOWRES
  131.         NOTE: if you don't need a quick wave pattern :-)
  132.         SPOTS=5                SPOTS=5
  133.         WAVE LENGHT=20            WAVE_LENGHT=15
  134.         SIZE=1                SIZE=1
  135.         DELAY=5                DELAY=10
  136.         COLORS=256            COLORS=32
  137.         RES.=LORES             RES=LOWRES
  138.         NOTE: GREAT but slow!
  139.   MostlyDark blanker
  140.   ------------------
  141.         AGA machines            NON-AGA machines
  142.         ~~~~~~~~~~~~            ~~~~~~~~~~~~~~~~
  143.         DENSITY=7            DENSITY=7
  144.         DELAY=2                DELAY=2
  145.         COLORS=32            COLORS=32
  146.         RES.=LOWRES            RES.=LOWRES
  147.         NOTE: the MostlyDark essence ...
  148.         DENSITY=8            DENSITY=8
  149.         DELAY=7                DELAY=8
  150.         COLORS=64            COLORS=32
  151.         RES.=LOWRES            RES.=LOWRES
  152.         NOTE: they seem stationary, but ...
  153.         DENSITY=2            DENSITY=2
  154.         DELAY=4                DELAY=4
  155.         COLORS=16            COLORS=16
  156.         RES.=HIGHRES NOFLICK.        RES.=HIGHRES
  157.         NOTE: very few pixels
  158.   Try 'em!
  159. @endnode
  160. @node "P5" "Paragraph 5: Bugs report and contributions"
  161.   The blankers have been developed and tested on an Amiga 4000/030 + 68882,
  162.   and they all seem to work right.
  163.   IF YOU ENCOUNTER SOME PROBLEMS INSTALLING THEM, FIND OUT SOME BUGS OR HAVE
  164.   --------------------------------------------------------------------------
  165.   SOME SUGGESTIONS (ABOUT THEM OR ABOUT NEW BLANKERS YOU WOULD LIKE TO HAVE)
  166.   --------------------------------------------------------------------------
  167.   @{"PLEASE CONTACT ME" link "P6"}!!!!
  168.   ---------------------
  169.   +--------------------------------------------------------------------+
  170.   |                                                                    |
  171.   | IF YOU INSTALL THEM AND LIKE THEM (OR HATE THEM) PLEASE SEND ME AN |
  172.   | ------------------------------------------------------------------ |
  173.   | @{"E-MAIL" link "P6"}: REALIZING THAT SOMEONE USE MY MODULES, WILL BOOST MY      |
  174.   | ------------------------------------------------------------       |
  175.   | BLANKERS-PRODUCTION !!! :-)                                        |
  176.   | ---------------------------                                        |
  177.   |                                                                    |
  178.   +--------------------------------------------------------------------+
  179. @endnode
  180. @node "P6" "Paragraph 6: About the author"
  181.   If you want to contact me: 
  182.   ------------------------------------------------------------------------
  183.     De Biasi Marzio
  184.     via Borgo Simoi, 34
  185.     31029 Vittorio Veneto (TV)
  186.     Italy                E-Mail: debiasi@dimi.uniud.it
  187.   _____________________________________-------------------------------____
  188. @endnode
  189. @node "P7" "Paragraph 7: Acknowledgements"
  190.   THANKS TO Micheal D. Bayne FOR HIS GREAT BLANKER.
  191.             ----------------
  192.   and to Martin Huttenloher for his beautiful MagicWB icons.
  193.   ... and thanks to all "GBlankerMod1" fans 8-). 
  194. @endnode
  195. @node "P8" "Paragraph 8: Distribution"
  196.   "Garshneblanker Modules Collection Volume I" package is FREEWARE.
  197.   You may freely distribute it as long as all of its files are included
  198.   in their original form without additions, deletions, or modifications,
  199.   and only a nominal fee is charged for its distribution. It cannot be
  200.   distributed as a part of commercial product without author's written
  201.   permission.
  202. * This program may be included in freeware collections, providing that the
  203.   previous conditions are respected.
  204. * TO SOFTWARE REVIEWS: if you include this program in one of your
  205.   disks, please send me a copy of the review, thanks :-)
  206. @endnode
  207. @node "P9" "Paragraph 9: Disclaimer"
  208.   No responsability or liability will be accepted for any damage that may
  209.   appear to have resulted from use of this program. All use is at your own
  210.   risk. The software is provided "as is" without any warranty implied or
  211.   otherwise to the fitness or accuracy of the software and documentation.
  212.   The author reserves the right to update the software and/or documentation
  213.   without notice.
  214. @endnode
  215. @node "P10" "Paragraph 10: advertising GBlankerMod1.lha ..."
  216.   You haven't downloaded it yet ... download it now!
  217.   GBlankerMod1.lha archive contains three new blankers for the great
  218.   Garshneblanker:
  219.     1) CrazyAnt blanker        : a blanker based on a 2D Turing machine.
  220.     2) Scrawls blanker        : a blanker based on iterated function
  221.                   systems (IFS).
  222.     3) Demons blanker        : a blanker based on a cellular automata.
  223.   You can find it on Aminet (util/blank directory :-).
  224. @endnode
  225. @node "T1" "Waves blanker"
  226.                     GarshneBlanker modules collection 
  227.             ---------------------------------
  228.                                  volume II
  229.                  ---------
  230.                          version 1.0 (Apr 04 1995)
  231.                   programs, sources and documentation are
  232.                       copyright 1995 Marzio De Biasi
  233.                             All Rights Reserved
  234.                                Waves blanker
  235.                                *************
  236.                                    v1.0
  237.                            technical information
  238. Description
  239. -----------
  240.   This blanker makes a wavy pattern on the screen then starts cycling the
  241.   colors.
  242.   In the wavy pattern, the color of each pixel is determined by the sum
  243.   of the sine of the distance between the pixel and one of the starting
  244.   spots.
  245. Garshneblanker preference window
  246. --------------------------------
  247.   You can set the following parameters:
  248.   Spots        : the number of starting spots. You can think of them as the
  249.   -----          "number of stones that will be thrown into your monitor";
  250.           if you "throw" a lot of stones the wavy pattern will be
  251.           very complex; if you "throw" only one stone the wavy
  252.           pattern will be made of concentric circumferences.
  253.   Wave lenght    : distance between the crests of two adjacent waves.
  254.   -----------
  255.   Size        : size of the pixels used for the wavy pattern; if you choose
  256.   ----          a true pixel (size=1), the generation of the wavy pattern
  257.           will be very slow. You can get good resuluts even with
  258.           5x5 pixels.
  259.   Delay        : cycling speed; lower values correspond to a faster cycle.
  260.   -----
  261. Algorithm description
  262. ---------------------
  263.   Sorry, no algorithm description (due to lack of time )-:
  264.   If you want to know more about the algorithm, take a look to the source
  265.   code.
  266. @endnode
  267. @node "T2" "MostlyDark blanker"
  268.                     GarshneBlanker modules collection 
  269.             ---------------------------------
  270.                                  volume II
  271.                  ---------
  272.                          version 1.0 (Apr 04 1995)
  273.                   programs, sources and documentation are
  274.                       copyright 1995 Marzio De Biasi
  275.                             All Rights Reserved
  276.                             MostlyDark blanker
  277.                             ******************
  278.                                    v1.0
  279.                            technical information
  280. Description
  281. -----------
  282.   This blanker "softly" flashes some white pixels on a dark screen;
  283.   consequently, your monitor looks like a very relaxing starfield.
  284. Garshneblanker preference window
  285. --------------------------------
  286.   You can set the following parameters:
  287.   Density    : the density of pixels that will appear on the screen.
  288.   -------
  289.   Delay        : controls the the flashing speed of the pixels; lower
  290.   -----          values of delay correspond to a faster flashing.
  291. Algorithm description
  292. ---------------------
  293.   No algorithm description for such a simple algorithm ;-)
  294. @endnode
  295.